<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
     share_tree - Sun Grid Engine share tree file format

DESCRIPTION
     The share tree defines the long-term  resource  entitlements
     of  users/projects  and  of  a hierarchy of arbitrary groups
     thereof.

     The current share tree can be  displayed  via  the  <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>
     -sstree  option.  The  output  follows the <I>share</I>_<I>tree</I> format
     description. A share tree can be created and an existing can
     be modified via the -astree and -mstree options to <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>.
     The -sst option shows a formatted share  tree  (tree  view).
     Individual  share  tree  nodes  can  be  created,  modified,
     deleted, or shown via the -astnode, -dstnode, -mstnode,  and
     -sstnode options to <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>.

     Note, Sun Grid Engine allows  backslashes  (\)  be  used  to
     escape  newline (\newline) characters. The backslash and the
     newline are replaced with a space (" ") character before any
     interpretation.

FORMAT
     The format of a share tree file is defined as follows:

     <B>o</B>  A new node starts with the attribute id, and  equal  sign
        and  the  numeric  identification  number  of  the  node.
        Further attributes of that node follow until another  id-
        keyword is encountered.

     <B>o</B>  The attribute type defines, if a  sharetree  node  refer-
        ences a user (type=0), or a project (type=1)

     <B>o</B>  The attribute childnodes contains a comma separated  list
        of child nodes to this node.

     <B>o</B>  The parameter name refers to an arbitrary  name  for  the
        node  or to a corresponding user (see <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) or project
        (see <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>) if the node is a leaf node of the  share
        tree. The name for the root node of the tree is "Root" by
        convention.

     <B>o</B>  The parameter shares defines the share of the node  among
        the nodes with the same parent node.

     <B>o</B>  A user leaf node named 'default' can be defined as a des-
        cendant  of  a  <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>)  node  in the share tree. The
        default node defines the number of shares for users   who
        are  running  in  the project, but who do not have a user
        node defined under the project. The default user node  is
        a  convenient  way  of  specifying  a single node for all
        users which should receive an equal share of the  project
        resources. The default node may be specified by itself or
        with other <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) nodes at the same level below a  pro-
        ject.  All  users, whether explicitly specified as a user
        node or those which map to the 'default' user  node  must
        have  a corresponding <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) object defined in order to
        get shares. Do not  configure  a  <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>)  object  named
        'default'.


EXAMPLES
     Jobs of projects P1 and P2 get 50 shares, all other jobs get
     10 shares.

     id=0
     name=Root
     type=0
     shares=1
     childnodes=1,2,3
     id=1
     name=P1
     type=1
     shares=50
     childnodes=NONE
     id=2
     name=P2
     type=1
     shares=50
     childnodes=NONE
     id=3
     name=default
     type=0
     shares=10
     childnodes=NONE

SEE ALSO
     <B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>, <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>, <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>.

COPYRIGHT
     See <B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B> for a full statement of rights and  permis-
     sions.












</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
